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PREFACE 


This document describes technical services provided to Rome Air 
Development Center by the] Measurement Concept Corporation under Contract 
F30602-79-C-0029. Three distinct efforts were performed by mc? to 
integrate the COMTAL Vision One Image Display System with existing tools 
present in RADC's TTI (Tactical Target Identification) laboratory, 
located in Building 112 at GAFB. The Froject Engineer of the subject 
effort was Mr. Richard Wood. 
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SUMMARY 


The technical services provided by Mc? to RADC under the subject contract 


added three tools to the Tactical Target Identification Labratory (TTIL) 
in Building 112. First, the COMTAL Vision One Image Processing System 
was made accessible to the PDP-11/40 processor under the RT-11 Single- 
User operating system. Second, the COMTAL Vision One was made to operate 
under the RSX-11M Multi-User Operating System, and was then integrated 
with the existing PAR-developed Radar Image Processing System. Third, 
the Syracuse Research Corporation's Radar Return and Airframe Display 
Program, SILHOUETTE, was successfully converted to RSX-11M, and software 
was written to allow the COMTAL device to replace the previously 
supported DEC VT-11 Calligraphic Display. 


In addition to these specific demonstrable tools, Mc? is leaving behind 
a general capability that will allow future TTIL users to easily communicate 
with the COMTAL system, both under RT-11 and under RSX-11M. 


The following documentation describes the three main efforts under this 
contract. Copies of all software discussed reside both on RK-05 disk packs, 
and on backup tape volumes. 


Many of the difficult problems encountered under this contract required 
trial-and-error solution, and the future avoidance of these problems by 
future TTIL users is an important legacy of this contract 


Because of the disjoint nature of the three tasks funded by this contract, 
this Final Technical Report will be divided into three sections, each 
describing a complete task. Interrelationships between these tasks, where 
they exist, are duly noted, and there is a certain amount of back-and- 
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out chronologically in the order presented. Each task was executed by 
a different member of Mc2's technical staff. The assignments are as 
fol lows: 


COMPIP: Richard Kellogg 
RIPS, RSX and COMTAL Conversion: James Tims 
SILHOUETTE Conversion: Robert A. McKie 


In conclusion, Mc? would Tike to express its appreciation of the assistance 
given by the staff of the TTI Laboratory, Mr. P. Grasso, Mr. N. Internicola, 
and particularily Mr. Ronald Blackall, who was a concerned source of 
unwritten documentation, and a co-equal contributor to the three efforts. 


Robert A. McKie, Project Manager 
Measurement Concept Corporation 


EVALUATION 


The Tactical Target Identification (TTI) Laboratory/Simulation program 
was instituted to exploit the hardware/software resources of the TTI 
Laboratory. The evolution of effective peripherals for Target Identification 
Simulation and Real Data Processing, required an equivalent upgrade of 
suftware capabilities, which included modifications and development of an 
effective operating system controller. This effort provided for the com- 
bining of various independent programs for more effective operator control, 
and established existing capabilities from one hardware system to a more 
effective peripheral. The capabilities of the TTI Laboratory have thus been 
enhanced in performance, adaptability to new programs, and ease of under- 
standing for future TTI applications. This effort was in accordance with TPO 
R2E to establish simulation capabilities for evaluation and validation of 
system programs for TTI assessments. 
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RICHARD J. WOOD 
Project Engineer 
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17.0 RT-11 COMTAL TO PDP-11 COMMUNICATIONS UTILITY 


The initial major task of the subject contract involved constructing 

a software package that would utilize the COMTAL DOS (Disk Operating 
System) device driver. This driver was modified by R. Kellogg to be 
usable under RT-11, but was tested initially on single lines of data. 

The objective of the initial effort was to construct a utility that would 
permit transfer of existing RIPS (Radar Image Processing System) 

files to the COMTAL for display. 


The resulting COMPIP (COMTAL PIP) system served a twofold purpose. 
First, it allowed verification and demonstration of the VISION ONE 

by providing it a source of “real" data. Second, COMPIP was designed 
in modules that would be relatively easy to convert to RSX-11M. 

This design supported the objective of adapting the RIPS system to 

use the COMTAL for graphic output which, in fact, was the second major 
task undertaken, described in Section 2.0. 


As constructed, COMPIP is a stand-alone program that functions much 
the same as the DEC PIP (Peripheral Interchange Program). It displays 
a list of COMTAL display options, requests a user selection from this 
list, then prompts the user into entering both file identification 
information and COMTAL memory identification information. Once 
entered, the information so described is written to or from the COMTAL. 


Although not designed to be used as a tool integratable with a user 
application, COMPIP can indeed be used as part of a user program by 
removing the COMPIP.FOR main program, and building the remaining 
modules into the user's task. 


The following paragraphs describe the functions of each of the 
software modules contiined in COMPIP. 
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1.1 COMPIP.FOR 
Author: R. Kellogg, Measurement Concept Corp., 1979. 


COMPIP is the main program of the COMPIP task. It uses FORTRAN Read/ 
Write statements to query the user regarding which COMTAL function 

he would like performed, then directs passage of control to the 
proper subroutine contained in CPIPSB.FOR. This program is 
essentially a "dummy" main calling program. 


1.2 CPIPSB.FOR 


CPIPSB.FOR contains the main subroutines for the program COMPIP. Each 
subroutine is a self-contained main section, and calls several of the 
COMTAL library routines, as well as other IPS file reading routines. 
The main routines in CPIPSB.FOR are: 


IWIMF - Read an IPS image file to the COMTAL. 

IRIMF - Write an IPS image file from the COMTAL 

IWGMF - Read an IPS graphics file to the CIMTAL. 

IRGMF - Write an IPS graphics file from the COMTAL. 
IWFMF - Read an IPS function file to the COMTAL. 

IRFMF - Write an IPS function file from the COMTAL. 
IWPSF - Read an IPS pseudo-color file to the COMTAL. 
IRPSF - Write an IPS pseudo-color file from the COMTAL. 


1.3 CPIPLB.FOR 


CPIPLB.FOR is a collection of subroutines that open, close, read and 
write various IPS files for use with COMPIP. When COMPIP is later 
re-written to be integrated as a RIPS “frame” option, the module 
will not be necessary. 
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The routines contained in CPIPLB. FOR are: 


IPROPE - Opens an IPS file for reading. 
IPWOPE - Opens an IPS file for output. 


IPRDIM - Reads one record from an IPS file to the user's buffer. 
IPWTIM - Writes one record from the user's buffer to an IPS file. 
IPCLOS - Closes an IPS file. 

IPRDPS - Reads one Pseudo-color Memory record into user buffer. 
IPWTPS - Writes a Pseudo-color Memory record to an IPS file. 


IPRDGM ~ Reads one line of Graphics Memory from an IPS file into 
the user buffer. 
IPWTGM - Writes one Graphic Memory record to an IPS file. 


IPROFM - Reads one Function Memory record from an IPS file to 
the user buffer. 
IPWIFM - Writes one Function Memory record to an IPS file. 


1.4 COMLO1.FOR 


COML@1.FOR is the first of five COMTAL library modules containing 
routines that support reading and writing to and from the COMTAL. 

COML@1 establishes some data definitions, common areas, data equivalences 
and COMTAL command word tables. It also contains two routines to 

open and close the COMTAL's I/0 channel: 


ICMOPE - Opens channel for COMTAL service. 
ICMCLO - Closes the COMTAL channel. 


1.5 COMLP2.FOR 


COML@2.FOR contains routines to read and write COMTAL "Image" and 
"Graphic" memories. 


IWIM - Writes one line of data from user memory to selected 
COMTAL Image Memory. 


IRIM 


IWGM 


IRGM 


ITC] 


Reads one line of data from selected COMTAL Image 
Memory to user buffer. 

Writes one line of data from user memory to the 
selected COMTAL Graphic Memory. 

Reads one line of data from the selected COMTAL 
Graphic Memory to the user buffer. 

Performs the actual "Transfer Code 1" command for the 
above four routines. 


1.6 COML3.FOR 


COML93.FOR contains routines to read and write COMTAL Function and 
Pseudo-color Memory. It contains the following routines: 


IWFM 


IRFM 


IWPS 


IRPS 


ITCc2 


Writes to the selected COMTAL Function Memory from the 
user buffer. 

Reads the selected Function Memory into the user 
buffer. 

Writes to the selected Pseudo-color Memory from the 
user buffer. 
‘Reads from the selected Pseudo-color Memory into 

the user buffer. 

Performs the actual "Transfer Code 2" command for the 
above four routines. 


1.7 COML@4.FOR 


COML@4.FOR contains routines to read and write the location of the 
COMTAL cursor. There are only two subroutines in this module. They 


are: 


WTP 
RTP 


Writes X, or Y, or both to the target cursor in the COMTAL. 
Reads the target cursor X, Y location into variables IX, IY. 


RT | (HEPES 


1.8 COML95.FOR 


COML@5.FOR contains routines to read and writ: blocks of text to 
and from the COMTAL, read and write the data block to and from the 
COMTAL, and read and write blocks of contiguous memory between the 
COMTAL and the host computer. The routines are: 


WCB - Transmit a block of text to the COMTAL text buffer. 

RCB - Read a block of text from the COMTAL text buffer. 

WOB - Transmit a Data Block to the COMTAL. The Data Block 
contains the contents of several display registers that 
determine the status of the COMTAL display. 

RDB - Reads the COMTAL Data Block. 

WCD - This routine is used to write any block of memory in the 
COMTAL. It primary use is down line loading code to the 
COMTAL, when COMTAL memory is acquired to support this 


loading. 
RCD - This routine reads any block of memory from the COMTAL. 
TC3. - This routine issues the "Transfer Code 3" command for the 


above six routines. 


1.9 Instructions for Building the COMPIP Task 


The following RT-11 commands are necessary to instruct the RT-11 
Linker to link together the various modules comprising COMPIP into an 
executable task image: 


-R LINK 
*COMPIP = COMPIP, CPIPSB, CPIPLB, SYSLIB/F/C 


*COML1, COMLP2, COML@3 (, COML24, COMLP5) 


1.10 To Run COMPIP 


-RUN COMPIP 
COMPIP will prompt the user for necessary input. 
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2.0 INTEGRATION OF THE COMTAL VISION ONE WITH THE RIPS (RADAR) IMAGE 
PROCESSING SYSTEM 


The PAR RIPS system was modified to incorporate a new option "frame". 
which allows a RIPS user to write and read information in RIPS format 

to and from the COMTAL Vision One display system. Mechanisms for adding 
functions to the RIPS system had been built in and documented by PAR, 
simplifying this effort by Mc*, 


The approach taken was to modify the COMTAL communication facilities 
provided by Mc? 's previous COMPIP subsystem to run under RSX-11M, and 
then to integrate this package with RIPS. Implicit in this effort was 
the thorough checkout of the COMTAL-supplied RSX-11M device driver, 
purchased under this contract. This handler is essentially a DEC 

DMA driver, modified by COMTAL to support their hardware. 


In addition to adding the COMTAL to RIPS as a valid input/output 
device, this sub-effort has produced a set of routines that can be 
used by any FORTRAN programmer for communicating with the COMTAL 
under RSX-11M. Evidence of this is the effort of Section III 
following, where the SRC SILHOUETTE program, written in FORTRAN under 
RT-11, was modified to use the COMTAL under RSX-11M. 


Instructions for altering the RIPS subsystem to acconmiocate another 


"menu" of user options were included in PAR's RIPS documentation. 


Stated briefly, these steps are: 


Se ee 


Update RIPS file FRAMES.SRC, which contains the text and 
control transfer codes of the screen menus appearing in 
RIPS, 


Run the FRAMES, program to convert the above file into its 
RIPS-usable form, FRAMES.IPS. 


Add control transfer code to RIPS module CALSUB. Re-~ 


-compile CALSUB. 


2-1 


rapitess sees Sag 


a 


to) Update the Overlay Descriptor Language File EXEC.ODL to 
incorporate any new Mc software being added to RIPS. 


fo) Compile or assemble new code to be incorporated in the 
modified RIPS system. 


(0) Run the indirect command file RIPSLNK to create the new 
version of RIPS. 


The accompanying listings show the code either written or modified 
by Mc® to add the COMTAL to RIPS. 


2-2 


2.1 FRAMES.SRC and FRAMES.IPS 
Modifications: 


A new RIPS "FRAME" or option menu was added to FRAMES.SRC to allow user 
selection of one of the nine COMTAL read/write functions added to RIPS. 
The following excerpt from FRAMES.SRC is annotated to indicate the 

code added by Mc? 


ie 

UTILITY FUNCTIONSS 
RSxS 

LOGS 

CALL_USER PROGRANS 
GENETATE TEST IMAGES 


CREHTE TEST IMAGES 
EXAMINE HEADER TEXTS 


ee FRAMES 


2 


9 
i 
0 
2 
() 
3 
oO 
4 
(9) 
s 
0 
6 
0 
? 
0 
8 
0 


Added by Mc 


one No 
~ 


SPLA 
RAGE 


ze5 
=8°, 


OPY OPTIONSS 
COMTALS 

ROM COMTALS 
ROM COMTALS 


LE FROM_CORNTALS 
TO COMTALS 


Om~NmMm TN 
C 
Dat en | 


RwuDB 


I 

0 
COPY PSEUDOCOLOR 
URITE COMMAND BL 
DISPLAY OPTIONSS 
MASTER FRAME 


(end of FRAMES .SRC 


83> 


2.2 CALSUB.FTN 
Modifications: 


fe) Computed "GO TO" statement, which is first executable state- 
ment of CALSUB, has the argument after 13 changed from a 
21 (signifying option not implemented) to a 14. 


) Code beginning one line before statement 14 and ending at 
the RETURN statement is added. These lines call the proper 
Mc? - written routine corresponding to the COMTAL option 
selected by the user from frame 14. 


2.3 EXEC.ODL 
Modifications: 


) Lines L34 - L39 are added, defining the residency 
requirements of all new code added by Mc’ to support the 
COMTAL . 


2.4 CPIPSB.FTN 

Authors: 
Written for RT-11 by R. Kellogg, Measurement Concept Corp., 1979. 
Adapted for RSX-11M by J. Tims, Measurement Concept Corp., 1979. 


CPIPSB can be thought of as the interface between Mc? software and 
the RIPS environment. CPIPSB provides the RIPS system access to Mc? 
software, while at the same time, insuring that all requests for 
normal RIPS I/0 services related to the COMTAL requests are passed 
through RIPS and RIPS's logging services. It is in actuality, a 

RIPS subroutine, written and added by Mc*. Other Mc? COMTAL software 


is independent of all RIPS conventions. 


CPIPSB contains nine subroutines, one corresponding to each of the 
RIPS frame 14 COMTAL options. 


2.5 COMLQ1.FOR 
Authors: 


Written for RT-11 by R. Kellogg, Measurement Concept Corp., 1979. 
Modified for RSX-11M by J. Tims, Measurement Concept Corp., 1979. 


COML@1 is a data definition block with no executable statements. It 
provides data element definition information, data equivalence inform- 
ation, and COMTAL function code arrays for passing to IWRITW, which 
performs the actual RSX-11M QI0$ operation. 


Information in COML@1 is used by COML@2, COML@3, COML@4 and COMLQ5. 
2.6 COML92.FOR 
Authors: 


Written for RT-11 by R. Kellogg, Measurement Concept Corp., 1979. 
Modified for RSX-11M by J. Tims, Measurement Concept Corp., 1979. 


COML@2 contains routines to support requests for 
0) Read/Write Image Memory 
rt) Read/Write Graphic Memory 


issued through CPIPSB (see Section 1.5). 
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2.7 COMLP3.FOR 


Authors: 


Written for RT-11 by R. Kellogg, Measurement Concept Corp., 1979. 
Modified for RSX-11M by J. Tims, Measurement Concept Corp., 1979. 


COML®3 contains routines to support requests for 
Read/Write Pseudocolor Memory 


fa) Read/Write Graphic Memory 


Issued through CPIPSB (see Section 1.6). 


2.8 COML@4.FOR 
Authors: 


Written for RT-11 by R. Kellogg, Measurement Concept Corp., 1979. 
Modified for RSX-11M by J. Tims, Measurement Concept Corp., 1979. 


COML@4.FOR is not used by the RIPS system. It consists of routines 
to 


a) Read/Write COMTAL target cursor 
and hence has no current function under RIPS (see Section 1.7). 
2.9 COML@5.FOR 


Authors: 


Written for RT-11 by R. Kellogg, Measurement Concept Corp., 1979. 
Modified for RSX-11M by J. Tims, Measurement Concept Corp., 1979. 


COML@5 contains routines to support requests for 
re) Xmit block of text to COMTAL 


This function is used in RIPS to format commands to the COMTAL to be 
interpreted by its MACRO interpreter. 


Although this is the only RIPS function supported, COML@5 contains 
many other capabilities not used by RIPS (see Section 1.8). 


fe) Read block of text from COMTAL 
fe) Xmit data block to COMTAL 
(0) Read data block from COMTAL 


te) Write block of PDP 11/40 memory to COMTAL (to be used when 
additional LSI-11 memory is purchased for down-line 
loading of COMTAL programs) 


rc) Read block of COMTAL LSI-11 memory from the PDP-11/40. 
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2.10 IWRITW.MAC 


Author: 
J. Tims, Measurement Concept Corp., 1979. 


IWRITW was written to mimic the RT-11 I/0 function IWRITW, which was 
used by COMPIP. It also includes code to mimic the RT-11 function 
routine IADDR, which would return the starting address of a FORTRAN 
parameter. No such routine exists within RSX-11M FORTRAN. 


IWRITW accepts I/O requests that "look like" RT-11 requests and 
converts them into RSX-11M QIOW$ requests. 


Also included in IWRITW.MAC is subroutine IBYTEX, which is used to 
swap high-and-low order bytes within a PDP-11 word. 
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2.11 Building the Modified RIPS Task 


To construct a new executable task image after modifying one or more 
of the source modules described previously, it is necessary to perform 
only three steps: : 


a. MCR>SET /UIC = [11, 11] 

b. Recompile or reassemble the affected source modules to obtain 
corresponding object modules. 

c. MCR>TKB @DK3:RIPSLNK 


It is assumed that: 


f°) RSX-11M system disk is mounted on drive 9 
0 MCC:RSX is mounted on drive 3. 
0 PAR Development Disk is mounted on drive 2. 


This will build the task "RIPS.TSK" on DK3 :[11, 11]. 


MCR>LOA ZB: (Load the COMTAL Device Driver) 
MCR>RUN RIPS (Run the task) 


1 
| 
MCR>INS DK3:RIPS (Install the task) | 
Once executing, RIPS prompts are self-explanatory. | 


2.13 Integration of Mice Software With Other User's Programs 


- Other users may gain access to the COMTAL under RSX-11M by including 
certain of the Mc? object modules in their task builder (TKR) command 
lines. Normally, the modules required wil] be: 
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COMLP1 . OBJ 
COMLP2 . OBJ 
COMLO3 . OBJ 
COML4 . OBJ 
COML®5 . OBJ 
IWRITW.OBJ 


This will give the user access to all the I/0 functions described 

in the documentation of COML@2 - COMLM5. If it is determined that 
all of these functions are not necessary for the user's program, it 
may be possible to remove one of the modules COML#2 - COMLP5 if none 
of the functions within the module are required by the user. In 

any case, COML@1 and IWRITW are required, and cannot be omitted. 
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3.0 COMTAL: mc? VERSION OF THE SRC SILHOUETTE PROGRAM 


The objective of this documentation is to describe FORTRAN code 
written to convert the SRC "SILHOUETTE" program to produce its 

output on the COMTAL Vision One Image Display System. Two conversions 
were necessary to achieve this objective: 


1. Conversion from the DEC RT-11 single user real-time system 
to the DEC RSX-11M multi-user real-time operating system. 


2. Conversion of graphic output from the calligraphic VT-11 
display device to the raster format COMTAL. 


The first conversion was primarily a matter of replacing some RT-11 

1/0 conventions with RSX conventions. As a previous task in the 
contract under which this work was being performed involved integration 
of the COMTAL under PAR's "RIPS" system, the necessary I/0 capabilities 
for the COMTAL under RSX were already available. Data for the SILHOUETTE 
program was transferred from RT-11 disks to Mc? 's RSX-11 disk by means 
of the DEC utility "FLX". 


The aircraft files were copied directly in ASCII mode. It was 

; discovered that the parameter and image files, when transferred in 

. "images" mode, were not readable by the RSX version of the SILHOUETTE 

' program, It was discovered that the RT-11 FORTRAN IV “unformatted read" 
statements used by SRC to create these files were incompatible with the 
RSX-117M FORTRAN IV "unformatted read" statements. After some experimenting, 
it was determined that if the “unformatted write” statements in the SRC 
RT-11 version were replaced with "unformatted direct access write" 
statements, then RSX-11M would be able to read them. 


2 A conversion program, called BOBTST.FOR was written to translate 
both image and parameter files from RT-11 unformatted to RT-11 direct 
access (unformatted). The corresponding read statements in the Mc? 
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version of "SILHOUETTE" were change to direct access reads. Then 


"FLX" was used (image Mode) to copy the output of "BOBTST" to the 
Mc? RSX~11M disk for use by "SILHOUETTE". 


Conversion of the graphic output of the SILHOUETTE program to a form 
acceptable to the COMTAL was a much more difficult task. Some form of 
lineal to raster conversion package had to be constructed to allow display 
of the aircraft files. The image files were somewhat simpler, requiring 
only coordinate system reversal (because of the COMTAL's implicit upper- 
left-hand-corner “origin"), translation, and 2-axis scaling, in 

addition to some linear expansion of each pixel's gradation. After 

some analysis, it was decided that because of the abbreviated time 

frame of the conversion effort, that program execution efficiency 

would be sacrificed, and that as few changes as possible would be 

made to the basic algorithms contained in the SRC program. Instead, 

Mc? wrote several routines which performed, in a raster environment, 
what the identically-named routines contained in the DEC RT-11, VT-11 
FORTRAN support library performed. 


The routine names and calling sequences were kept identical. Some 
new subroutines were written to accomplish, in software, what the 
VT-11 accomplished in hardware, primarily dealing with image origin 
and scaling. Routines supporting communication with the COMTAL 
under RSX-11M were task-built into the new SILHOUETTE executable 
task. 


3.1 Operation of the New SILHOUETTE Program 


3.1.1] Preparation for Execution 


3.1.1.1 Conversion of Data Files 


At present, only the aircraft files LEARJT.DAT, FI5A.DAT and T33A.DAT 
have been converted from RT-11 to RSX-11M. The following instructions 
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should be followed to convert other (aircraft, parameter, image) 
file groupings that may be of interest. 


(a) Parameter and Image files 


= Mount Mo? RT-11 system packs on RK-05 drive @ and 
the RT-11 data source pack on drive 1. Boot RT-11. 


- RUN DK@:BOBTST. Respond to prompt "PARAMETER FILE 
NAME" by typing the full specification of the RT-11 
parameter input file: i.e., DK1:T33A1P.DAT. 


- Respond to prompt "ENTER DESTINATION FILE NAME" by 


typing the same file name, preceded by a different 
disk prefix, in this case: DK@:T33A1P.DAT. 
| 
I 
| 
i 


- Respond to “IMAGE FILE NAME" by typing the full 
specification of the image file name, i.e.: DK1:T33A1.DAT. 


| - Respond to “ENTER DESTINATION FILE NAME" by typing 
! the same file name, preceded by a different disk 
"prefix, i.e.: DK@:T33A1.DAT. 


, 
| As it exists, the program terminates with a "STOP" after each file 
| pair converted, and must be re-run for every conversion desired. 


? 0 Aircraft files were written as ASCII card images, and hence 
do not need the conversion provided by BOBTST .FOR. 


fC) Transfer of files from RT-11 to RSX-11M: The RSX utility 
"FLX" is used to transfer files from an RT-11 disk to an 
RSX-11M disk. The following instructions apply. 


% - Mount Mc? RSX-1] disk on drive 9; RT-11 disk containing 


converted files on any other drive. 
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- Boot RSX and: SET /uIc=£1,123] 
- Invoke "FLX". 


- For each file triple, copy from RT-1] disk "n" to 
the disk labeled MCC:RSX, mounted on drive "m" as in 
the following example: 


-- Copy aircraft file: Dkm:=DKn:T33A.DAT/RT 
-- Copy parameter file: Dkm:=DKn:T33AI1P.DAT/RT/IM 
-- Copy image file: Dkm: =DKn:T33A1.DAT/RT/IM 
3.1.2 Preparation for Execution of “SILHOUETTE” Program 
3.1.2.1 Load The COMTAL Handler 


The software device handler for the COMTAL must be loaded after system 
bootstrap, as it is normally non-resident in the RSX nucleus. Once 
loaded, it will remain resident until removed, or until the system 

is re-booted. . 


MCR>LOA ZB: 
3.1.2.2 Instal) the "SILHOUETTE" Task 
MCR>INS DKm:COMTAL where m is the drive number of the Mc? RSX disk. 
3.1.2.3 Run the Task 


MCR>RUN COMTAL 


3.1.3 Operator Interaction with the SILHOUETTE Program 
3.1.3.1 Introduction 


An attempt was made to retain as much of the SRC SILHOUETTE prompting 
mechanism as possible. Some areas of difference exist because of 

the nature of the COMTAL, and an important improvement was made to 
the SRC version, allowing user specification of aircraft attitude in 
terms of yaw, pitch and roll angles, rather than the previous slant 
range and cross range unit orthogonal vectors, which were non- 
intuitive, and impossible to calculate mentally except in very special 


cases. 


The other changes involve user specification of the COMTAL image 
memory to contain the resultant radar return image, and of the COMTAL 
graphic memory, which will contain the aircraft silhouette. There are 
three image memories and four graphic memories in the current Vision 
One, but Mc? programs preclude reading from or writing to the fourth 
graphic memory. 


Translation of the aircraft silhouette, usually as a means of having 
jt overlay the radar return image, was accomplished dynamically on 

the VT-1] by means of lightpen instruction. Such capability is 

not possible on the COMTAL becuase of the raster graphic organization, 
so the tracking function is replaced with a translation function 

that allows the user to specify how far (in pixels) the user wishes 
the image moved in the X and Y screen coordinate system. This 
translation process may be iterated as many times as desired, allowing 


at least the precision of the VT-11 lightpen translation. 


3.1.3.2 User Interaction 


SET ulc+01,1239 
er. meee we) 

SENS BARE CONTHL 
RUN CONTHL 


AIRCRAFT SILHOUETTE DISPLAY 


ENTER OPERATIONAL MODE 
1 = IMAGE DRIVEN MObE 

| 27 STAND-ALONE MODE 

SILMOUETTE FILE NAME 

PR3:F1SA.DAT 

IMAGE FILE NAME 

PK3:F 1SaL. DAT 

PRRMMETER FILE NAME 


DATE AISALP. DAT 
ENTER COMTAL IMAGE NEMORY NUMBER: (1-3) 


ENTER CONTAL GRAPHIC MEMORY NUMBER (1-3): 
TRANSLATE GRAPHIC (YES/NO) 


ves 

pa TRENT ALLENS? X,Y CREAL, SIGNED NUMBERS ) 
-30.,-64. 

tet GRAPHIC CYES/NO) 

ter 


NEU PROJECTION cVES“NO) 
ho 


NEW FILE ©VES“NO) 
aie 


FRouRwM "STLHOUETTE’ TERMINATED BY OPERATOR 
CONTaL ~- STOP 


Figure 3-1 Sample Command Printout 


3.1.4 Building "COMTAL", The Mc? Version of "SILHOUETTE" 


All source code, object modules, utilities and data for the "COMTAL" 
task reside on the disk labeled "MCC:RSX", under UIC=[1,123]. 


If modification to the adopted SILHOUETTE system is necessary, the 
user should perform the following steps: 


a. Edit and recompile the affected module(s) 
MCR>TKB @DK3:COMTAL 


This second step invokes an indirect command file, which contains 
all information regarding the program contents and logical unit 
assignments of the resultant task "COMTAL". 


3.2 Modification and Additions to SRC Software 

3.2.1 Modifications to SLMAIN.FIN 

3.2.1.1 Common Areas 

GBUF - graphic airframe buffer and current X, Current Y counters. 

LOWLFT~ X, Y coordinates of VT-11 lower screen left, and X, Y 
translation quantities. 


LAST - X, Y coordinates of last point written to graphic image 
buffer. 
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3.2.1.2 Storage 


GBUF (8192) ~ 256 x 256 x 1 bit graphic pixel buffer, stored in 
screen rows, top to bottom. 

GBUF2 (32) - 256 x 1 bit graphic line buffer, for output routines. 

XSHFT, YSHFT-~ initially zero, these are displacements of the graphic 
image in COMTAL frame, created by the user's previous 
image translation requests. This allows translations 
from the last graphic image location, rather than from 
the initial position. 


3.2.1.3 Logic Changes 


To convert the SILHOUETTE Program to RSX-11M, it was necessary, as pre- 
viously indicated, to translate the parameter and image files from RT-11 
FORTRAN unformatted I/0 to direct access unformatted 1/0, which is 
compatible with RSX. It was also necessary to insert calls to a 

small subroutine, FLEASN (F IL E ASS 1GN), that prompts the user 
to enter the names of the aircraft, parameter and image files. This 

{ function was previously performed by a special option within the RT-1] 
"ASSIGN" subroutine, which is not present in RSX FORTRAN. "Define File” 
Statements were added to supply information about the parameter and 
image files. 


ae- 
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As an improvement to the original SRC method of specifying aircraft 
attitude in terms of unit slant range and cross range vectors, Mc? 
wrote a subroutine called "ROTATE" that accepts yaw, pitch and roll 
angles, and constructs the unit vectors from this information. 


The VT-11 light pen tracking routine, which allowed the user to 
superimpose the aircraft image over the radar return image, has been 
replaced by a prompt requesting the user to enter, if he wishes to 
translate the image, the signed displacement of the aircraft image that 
is desired. This translation is measured in pixels and is referenced 
to the lower left corner of the screen. The COMTAL MACRO routine "INS" 
can be used to determine the translation values. 


Variable SSZ, screen size in inches, was changed from 12. to 10.5, the 
visible dimension of the COMTAL. 


3.2.1.4 Known Problems 


3.2.1.4.1 Byte Exchange 


The COMTAL supplied RSX-11 device handler does not swap bytes within a 
PDP-11 word during a transfer, as its RT-11 predecessor did. For this 
reason, routine IBYTEX is called to place the pixels in proper logical 
order before transfer. 


3.2.1.4.2 Specification of a New File While in Image-Driyen Mode, 
(Node T) - 


Due to some quirk of FORTRAN, attempts to close a parameter and image 
file and re-open a new set of parameter and image files results ina 


file name specification error, that could not be fully understood because 


of missing RSX-11M FORTRAN documentation. As a temporary measure, the 

statement at line #47 will bypass this problem by directing all requests 
for "new file" while in Mode 1 to a graceful exit: the new file can be 
used by re-running "COMTAL". 
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3.2.2 Modification to SLSUBS.FTN 


SLSUBS is a collection of FORTRAN subroutines, written by SRC, that has 
been modified as little as possible for use in the COMTAL version of 
SILHOUETTE. One routine, FLEASN, was added to read file names for the 
ASSIGN calls in SLMAIN. 


The following COMMON areas and variables apply to one or more members 
of SLSUBS. Logic changes will be discusson a routine-by~-routine basis. 


3.2.2.1 Common Areas 


SCALE - holds scaling factor for aircraft SILHOUETTE construction. 
LAST - See SLMAIN. 
LOWLFT - See SLMAIN. 
GBUF - See SLMAIN. 


-2.2 Storage 


GBUS (8192) Graphic pixel buffer. 

COORD (6) A temporary buffer for holding data values and 
applying the scale factor (SCL) to them. 

D(256) Image line buffer, input (real data). 

ITEXT (8) LOGICAL*1 array to store "CLEAR IMAGE BUFFER" 
command. 

IMLINE 256-byte image line output buffer. 


3.2.2.3 Logic Changes 
3.2.2.3.1 Subroutine Draw 


Subroutine ADJUST, which multiplies all VT-11 coordinate positions by 

the scale factor SCL computed by Subroutine SCALE, appears directly before 
calls to routines writing points, lines and circles. This routine simulates 
the VT-1] hardware scaling feature. 
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3.2.2.3.2 Subroutine CIRCLE 

No changes. 

3.2.2.3.3 Subroutine CYLNDR 

Other than call to ADJUST at Line #10, no changes. 
3.2.2.3.4 Subroutine PASS2 


@ Lines #35-40, prompt for specification of image buffer to be 
used. 

@ Lines #41-47, clears proper COMTAL image buffer. 

@ Line #66, image intensity level is extended to 8 bits from 
the 3 bits of the VT-11. 

@ Lines #72-75, write a line of the image to the COMTAL, 


3.2.2.3.5 Subroutine TVECT 
No changes. 
3.2.2.3.6 Subroutine PLOT 
No changes. 


3.2.2.3.7 Subroutine FLEASN 


Allows user to enter filenames of aircraft, parameter and image files. 


3.2.3  COMGRF.FTN 


COMGRF is a set of FORTRAN routines that emulate on the COMTAL routines 
of the same name in the DEC VT-11 support library. These routines allow 
most of the other SILHOUETTE software to be very similar to the RT-11 
version. 


3.2.3.1 Subroutine SCAL (Min x, Min y, Max x, Max y) 


Determines the spread between (Min x, Max x) and (Min y, Max y) and 

finds the larger difference, which is then divided by 1024 to get the 

VT-11 distance per unit increment. This is done because the COMTAL is a square 
display, rather than rectangular. The coordinates of the lower left 

corner of the display are determined by adding together 512 (to convert 

from the VT-11 SILHOUETTE convention of a center-screen origin) and 

four times the desired pixel displacement. 


3.2.3.2 Subroutine APNT 


Resets the current x, current y counters to the x, y specified in the 
argument list. Currently unused by SILHOUETTE. 


3.2.3.3 Subroutine RDOT (DX, DY) 


Moves the current x, y pointers to (CX+DX, CY+DY) and calls CDOT to 
illuminate that pixel. 


3.2.3.4 Subroutine LVECT (DX, DY) 


LVECT is a lineal to raster conversion routine that "draws" a straight 
line in the graphic buffer between (CX, CY) and (CX+DX, CY+DY). LVECT 
determines the slope of this line. If the absolute value of the slope 
is less than 1, then the line is described by a formula of the form 

y = f(x). Conversely, if the absolute value of the slope is >1, then 

the line is described in the form x=f(y). 


After the line's equation has been calculated, discrete values of the 
equations dependent variable are calculated by stepping the independent 
variable between its input limits in unit intervals. As the dependent 
variable is rarely of integer value, it is rounded up or down to its 
nearest integral value. Subroutine CDOT is called to place each (integral 
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independent variable, dependent variable) pair in the graphic display 
buffer. When all such pairs have been sent, the current x and current 
y counters are updated to reflect the end of the line. 


3.2.3.5 Subroutine CDOT (x, y) 


Subroutine CDOT accepts pixel addresses in the VT-11 1024 x 1024 coordinates 
frame (Lower Left Origin), and converts these to pixels in the COMTAL 

256 x 256 upper left origin frame. It then calculates the bit address 

of the pixel in array "GBUF" and sets this bit. 


Quantities XLAST and YLAST contain the last x, y position set in the 
COMTAL buffer. If a request to set the same bit as set in the last call 
to CDOT (which often happens because of the 4:1 coordinate frame 
shrinkage), the request is ignored. Otherwise, XLAST, YLAST is reset to 
reflect the current request and the bits in GBUF are set. 


3.2.3.6 Subroutine ADJUST 


This routine accepts an array of real variables and a counter N, and 
applies the multiplicative scale factor SCL to the first N values of 
the array. This allows one routine to suffice for line and point 
requests, which have three parameters requiring scaling, and the circle 
requests, which have four scalable parameters. 


3.2.4 Subroutine ROTATE 


Subroutine ROTATE accepts three real, signed input parameters, which 
correspond to yaw, pitch and roll angles. 


Yaw is measured clockwise if looking down onto top of aircraft. Pitch 
is measured positive if aircraft nose is pointed above horizontal, 
negative below. Roll is measured position clockwise when looking down 
the aircraft fuselage. 
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The input values, in signed degrees, are converted to radians, 
and unit vectors RS and RC are calculated from these values. 


3.2.5 VECTOR. FIN 


The three vector algebra routines UNITV, DOTP and CROSSP are used without 
change from their RT-11 versions. 


3.2.6 Other Programs 


3.2.6.1 BOBTST.FTN 


This stand-alone RT-11 program assists the user in copying RT-11 FORTRAN 
unformatted files to RT-11 direct~access format. The direct access 
format is compatible with RSX-11M FORTRAN, and can be "FLX'ed" from an 
RT-11 pack to an RSX-11M pack for use with the SILHOUETTE Program. 


It is necessary to specify different disk packs for source and 
destination files when running this program so that the original file 
name can be retained. This is important becuase FLX wil] not support 
the renaming of files during transfer. 


3.2.6.2 COMTAL.CMD_ 


This file is the task builder indirect command file that builds the 
task COMTAL, which is the Mc2 version of the SRC task SILUET. SAV. 
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